---
title: Introduction
description: "Welcome to OASIS: Open Agent Social Interaction Simulations with One Million Agents"
---

<img
  className="block dark:hidden"
  src="/images/oasis_intro.png"
  alt="Hero Light"
/>
<img
  className="hidden dark:block"
  src="/images/oasis_intro.png"
  alt="Hero Dark"
/>

## What is OASIS?

🏝️ OASIS is a scalable, open-source social media simulator that integrates large language models with rule-based agents to realistically mimic the behavior of up to one million users on platforms like Twitter and Reddit. It's designed to facilitate the study of complex social phenomena such as information spread, group polarization, and herd behavior, offering a versatile tool for exploring diverse social dynamics and user interactions in digital environments.

<img
  className="block"
  src="/images/oasis_main.png"
  alt="OASIS Main"
/>

## Key Features

<CardGroup cols={2}>
  <Card
    title="Scalability"
    icon="chart-line"
    href="https://github.com/camel-ai/oasis/blob/main/oasis/social_agent/agent.py"
  >
    Supports simulations of up to <b>one million agents</b>, enabling studies of social media dynamics at a scale comparable to real-world platforms
  </Card>
  <Card
    title="Dynamic Environments"
    icon="mobile-screen"
    href="https://github.com/camel-ai/oasis/blob/main/oasis/social_platform/platform.py"
  >
    Adapts to real-time changes in social networks and content, mirroring the fluid dynamics of platforms like <b>Twitter</b> and <b>Reddit</b> for authentic simulation experiences
  </Card>
  <Card
    title="Diverse Action Spaces"
    icon="thumbs-up"
    href="https://github.com/camel-ai/oasis/blob/main/oasis/social_agent/agent_action.py"
  >
    Agents can perform <b>23 different actions</b>, such as following, commenting, reposting, and quoting for rich, multi-faceted interactions
  </Card>
  <Card
    title="Recommendation Systems"
    icon="fire"
    href="https://github.com/camel-ai/oasis/blob/main/oasis/social_platform/recsys.py"
  >
    Features <b>interest-based</b> and <b>hot-score-based</b> recommendation algorithms, simulating how users discover content on real social media platforms
  </Card>
</CardGroup>

## Use Cases

<CardGroup cols={2}>
  <Card
    title="Research Simulations"
    icon="flask"
    href="https://arxiv.org/abs/2411.11581"
  >
    Study complex social phenomena like information spread, group polarization, and collective behavior at scale
  </Card>
  <Card
    title="Interactive Environments"
    icon="users"
    href="https://arxiv.org/abs/2411.11581"
  >
    Create dynamic environments for testing human-agent interactions and social dynamics
  </Card>
  <Card
    title="Content Creation"
    icon="pen-to-square"
    href="https://arxiv.org/abs/2411.11581"
  >
    Generate realistic social media content and interactions for creative or educational purposes
  </Card>
  <Card
    title="Behavior Prediction"
    icon="chart-simple"
    href="https://arxiv.org/abs/2411.11581"
  >
    Model and predict how information and behaviors might spread through social networks
  </Card>
</CardGroup>

## Getting Started

Learn how to set up and use OASIS for your social simulation needs.

<CardGroup cols={2}>
  <Card
    title="Installation"
    icon="download"
    href="https://docs.oasis.camel-ai.org/quickstart"
  >
    Get OASIS set up on your local environment with our step-by-step guide
  </Card>
  <Card
    title="Tutorials"
    icon="book-open"
    href="https://docs.oasis.camel-ai.org/user_generation/generation"
  >
    Learn how to create user profiles and run your first simulation
  </Card>
  <Card
    title="Documentation"
    icon="file-code"
    href="https://docs.oasis.camel-ai.org"
  >
    Explore the full capabilities of OASIS through our comprehensive docs
  </Card>
  <Card
    title="Community"
    icon="users"
    href="https://github.com/camel-ai/oasis"
  >
    Join our Discord, Reddit, X, and WeChat groups to connect with other OASIS users
  </Card>
</CardGroup>

## Resources

<CardGroup cols={2}>
  <Card
    title="Research Paper"
    icon="file-lines"
    href="https://arxiv.org/abs/2411.11581"
  >
    Read the foundational research paper detailing OASIS methodology and findings
  </Card>
  <Card
    title="Example Scripts"
    icon="code"
    href="https://github.com/camel-ai/oasis/tree/main/examples"
  >
    Explore example scripts for running various types of simulations
  </Card>
  <Card
    title="Dataset"
    icon="database"
    href="https://huggingface.co/datasets/oasis-agent/oasis-dataset"
  >
    Access our comprehensive dataset of agent interactions on Hugging Face
  </Card>
  <Card
    title="Demo Videos"
    icon="video"
    href="https://www.youtube.com/watch?v=wjLHrdZ1Smk"
  >
    Watch demonstrations of OASIS capabilities and simulation examples
  </Card>
</CardGroup>
